﻿using System;
using System.Collections.Generic;
namespace WooCoo.IoC
{
    /// <summary>
    /// 继承该接口以实现WooCoo中的IOC功能
    /// </summary>
    public interface IContainer
    {
        /// <summary>
        /// 获取当前的IOC容器实例
        /// </summary>
        object Instance { get; }
        /// <summary>
        /// 具有从指定的类型参数派生的协定名称的已导出对象
        /// </summary>
        /// <typeparam name="T">要返回的已导出对象的类型。 协定名称也派生自此类型参数。</typeparam>
        /// <remarks>
        /// 返回具有从指定的类型参数派生的协定名称的已导出对象。 如果不是正好有一个匹配的已导出对象，则将引发异常
        /// </remarks>
        /// <returns>具有从指定的类型参数派生的协定名称的已导出对象。</returns>
        T GetExportedValue<T>();
        /// <summary>
        /// 返回具有指定的协定名称的已导出对象。如果不是正好有一个匹配的已导出对象，则将引发异常。
        /// </summary>
        /// <typeparam name="T">要返回的已导出对象的类型。</typeparam>
        /// <param name="contractName">要返回的已导出对象的协定名称，或者为 null 或空字符串 ("") 以使用默认的协定名称。</param>
        /// <returns></returns>
        T GetExportedValue<T>(string contractName);
        /// <summary>
        /// 获取具有从指定的类型参数派生的协定名称的所有已导出对象。
        /// </summary>
        /// <typeparam name="T">要返回的已导出对象的类型。</typeparam>
        /// <returns></returns>
        IEnumerable<T> GetExportedValues<T>();
        /// <summary>
        /// 获取具有从指定的类型参数派生的协定名称的所有已导出对象。
        /// </summary>
        /// <param name="contractName">要返回的已导出对象的协定名称，或者为 null 或空字符串 ("") 以使用默认的协定名称。</param>
        /// <returns></returns>
        IEnumerable<T> GetExportedValues<T>(string contractName);
        /// <summary>
        /// 获取指定的协定名称的一个已导出对象,协定名默认导入类型的命名空间限制名
        /// </summary>
        /// <param name="contractName">要返回的已导出对象的协定名称。</param>
        /// <param name="export">已导出对象</param>
        /// <returns></returns>
        bool TryGetExports(string contractName, out object export);
        /// <summary>
        /// 获取指定的协定名称的一个已导出对象，协定名默认导入类型的命名空间限制名
        /// </summary>
        /// <param name="exportType">需要导出的对象类型</param>
        /// <param name="contractName">要返回的已导出对象的协定名称。</param>
        /// <param name="export">已导出对象</param>
        /// <returns></returns>
        bool TryGetExports(Type exportType, string contractName, out object export);
    }
}
